home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat1 / pr.z / pr
Encoding:
Text File  |  1998-10-20  |  9.9 KB  |  199 lines
  1.  
  2.  
  3.  
  4. PPPPRRRR((((1111))))                                                                    PPPPRRRR((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      pr - print files
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      pppprrrr [[----ccccoooolllluuuummmmnnnn] [----wwwwwidth] [----aaaa]] [----eeeeck] [----iiiick] [----ddddrrrrttttffffpppp] [++++page] [----nnnnck]
  13.      [----oooooffset] [----lllllength] [----ssssseparator] [----hhhhheader] [file ...]
  14.  
  15.      pppprrrr [[----mmmm] [----wwwwwidth]] [----eeeeck] [----iiiick] [----ddddrrrrttttffffpppp] [++++page] [----nnnnck] [----oooooffset]
  16.      [----lllllength] [----ssssseparator] [----hhhhheader] file1 file2 ...
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      _p_r is used to format and print the contents of a file.  If _f_i_l_e is ----, or
  20.      if no files are specified, _p_r assumes standard input.  _p_r prints the
  21.      named files on standard output.
  22.  
  23.      By default, the listing is separated into pages, each headed by the page
  24.      number, the date and time that the file was last modified, and the name
  25.      of the file.  Page length is 66 lines which includes 10 lines of header
  26.      and trailer output.  The header is composed of 2 blank lines, 1 line of
  27.      text ( can be altered with ----hhhh), and 2 blank lines;  the trailer is 5
  28.      blank lines.  For single column output, line width may not be set and is
  29.      unlimited.  For multicolumn output, line width may be set and the default
  30.      is 72 columns.  Diagnostic reports (failed options) are reported at the
  31.      end of standard output associated with a terminal, rather than
  32.      interspersed in the output.  Pages are separated by series of line feeds
  33.      rather than form feed characters.
  34.  
  35.      By default, columns are of equal width, separated by at least one space;
  36.      lines which do not fit are truncated. If the ----ssss option is used, lines are
  37.      not truncated and columns are separated by the _s_e_p_a_r_a_t_o_r character.
  38.  
  39.      Either -_c_o_l_u_m_n or ----mmmm should be used to produce multi-column output.  ----aaaa
  40.      should only be used with -_c_o_l_u_m_n and not ----mmmm.
  41.  
  42.      Command line options are
  43.  
  44.      ++++_p_a_g_e     Begin printing with page numbered _p_a_g_e (default is 1).
  45.  
  46.      ----_c_o_l_u_m_n   Print _c_o_l_u_m_n columns of output (default is 1).  Output appears
  47.                as if ----eeee and ----iiii are turned on for multi-column output.  May not
  48.                use with ----mmmm.
  49.  
  50.      ----aaaa        Print multi-column output across the page one line per column.
  51.                _c_o_l_u_m_n_s must be greater than one.  If a line is too long to fit
  52.                in a column, it is truncated.
  53.  
  54.      ----mmmm        Merge and print all files simultaneously, one per column.  The
  55.                maximum number of files that may be specified is eight.  If a
  56.                line is too long to fit in a column, it is truncated.  May not
  57.                use with -_c_o_l_u_m_n.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPRRRR((((1111))))                                                                    PPPPRRRR((((1111))))
  71.  
  72.  
  73.  
  74.      ----dddd        Double-space the output.  Blank lines that result from double-
  75.                spacing are dropped when they occur at the top of a page.
  76.  
  77.      ----eeee_c_k      Expand input tabs to character positions _k+1, 2*_k+1, 3*_k+1,
  78.                etc.  If _k is 0 or is omitted, default tab settings at every
  79.                eighth position are assumed.  Tab characters in the input are
  80.                expanded into the appropriate number of spaces.  If _c (any
  81.                non-digit character) is given, it is treated as the input tab
  82.                character (default for _c is the tab character).
  83.  
  84.      ----iiii_c_k      In output, replace white space wherever possible by inserting
  85.                tabs to character positions _k+1, 2*_k+1, 3*_k+1, etc.  If _k is 0
  86.                or is omitted, default tab settings at every eighth position
  87.                are assumed.  If _c (any non-digit character) is given, it is
  88.                treated as the output tab character (default for _c is the tab
  89.                character).
  90.  
  91.      ----nnnn_c_k      Provide _k-digit line numbering (default for _k is 5).  The
  92.                number occupies the first _k+1 character positions of each
  93.                column of single column output or each line of ----mmmm output.  If _c
  94.                (any non-digit character) is given, it is appended to the line
  95.                number to separate it from whatever follows (default for _c is a
  96.                tab).
  97.  
  98.      ----wwww_w_i_d_t_h   Set the width of a line to _w_i_d_t_h character positions (default
  99.                is 72).  This is effective only for multi-column output (-
  100.                _c_o_l_u_m_n and ----mmmm).  There is no line limit for single column
  101.                output.
  102.  
  103.      ----oooo_o_f_f_s_e_t  Offset each line by _o_f_f_s_e_t character positions (default is 0).
  104.                The number of character positions per line is the sum of the
  105.                width and offset.
  106.  
  107.      ----llll_l_e_n_g_t_h  Set the length of a page to _l_e_n_g_t_h lines (default is 66).  ----llll0
  108.                is reset to ----llll66.  When the value of _l_e_n_g_t_h is 10 or less, ----tttt
  109.                appears to be in effect since headers and trailers are
  110.                suppressed.  By default, output contains 5 lines of header and
  111.                5 lines of trailer leaving 56 lines for user-supplied text.
  112.                When ----llll_l_e_n_g_t_h is used and _l_e_n_g_t_h exceeds 10, then _l_e_n_g_t_h-10
  113.                lines are left per page for user supplied text.  When _l_e_n_g_t_h is
  114.                10 or less, header and trailer output is omitted to make room
  115.                for user supplied text.
  116.  
  117.      ----hhhh _h_e_a_d_e_r Use _h_e_a_d_e_r as the text line of the header to be printed instead
  118.                of the file name.  ----hhhh is ignored when ----tttt is specified or
  119.                ----llll_l_e_n_g_t_h is specified and the value of _l_e_n_g_t_h is 10 or less.
  120.                (----hhhh iiiissss tttthhhheeee oooonnnnllllyyyy _p_r option requiring space between the option
  121.                and argument.)
  122.  
  123.      ----pppp        Pause before beginning each page if the output is directed to a
  124.                terminal (_p_r will ring the bell at the terminal and wait for a
  125.                carriage return).
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PPPPRRRR((((1111))))                                                                    PPPPRRRR((((1111))))
  137.  
  138.  
  139.  
  140.      ----ffff        Use single form-feed character for new pages (default is to use
  141.                a sequence of line-feeds).  Pause before beginning the first
  142.                page if the standard output is associated with a terminal.
  143.  
  144.      ----rrrr        Print no diagnostic reports on files that will not open.
  145.  
  146.      ----tttt        Print neither the five-line identifying header nor the five-
  147.                line trailer normally supplied for each page.  Quit printing
  148.                after the last line of each file without spacing to the end of
  149.                the page.  Use of ----tttt overrides the ----hhhh option.
  150.  
  151.      ----ssss_s_e_p_a_r_a_t_o_r
  152.                Separate columns by the single character _s_e_p_a_r_a_t_o_r instead of
  153.                by the appropriate number of spaces (default for _s_e_p_a_r_a_t_o_r is a
  154.                tab).  Prevents truncation of lines on multicolumn output
  155.                unless ----wwww is specified.
  156.  
  157. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  158.      Print ffffiiiilllleeee1111 and ffffiiiilllleeee2222 as a double-spaced, three-column listing headed by
  159.      ``file list'':
  160.  
  161.           pppprrrr ----3333ddddhhhh """"ffffiiiilllleeee lllliiiisssstttt"""" ffffiiiilllleeee1111 ffffiiiilllleeee2222
  162.  
  163.      Copy ffffiiiilllleeee1111 to ffffiiiilllleeee2222, expanding tabs to columns 10, 19, 28, 37, ... :
  164.  
  165.           pppprrrr ----eeee9999 ----tttt <<<<ffffiiiilllleeee1111 >>>>ffffiiiilllleeee2222
  166.  
  167.      Print ffffiiiilllleeee1111 and ffffiiiilllleeee2222 simultaneously in a two-column listing with no
  168.      header or trailer where both columns have line numbers:
  169.  
  170.           pppprrrr ----tttt ----nnnn ffffiiiilllleeee1111 |||| pppprrrr ----tttt ----mmmm ----nnnn ffffiiiilllleeee2222 -
  171.  
  172. FFFFIIIILLLLEEEESSSS
  173.      /dev/tty*     If standard output is directed to one of the special files
  174.                    ////ddddeeeevvvv////ttttttttyyyy****, then other output directed to this terminal is
  175.                    delayed until standard output is completed.  This prevents
  176.                    error messages from being interspersed throughout the
  177.                    output.
  178.  
  179. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  180.      cat(1), fold(1), pg(1).
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.